Tech Arsenal 1/Tech Arsenal (Arsenal Computer).ISO/tek-20/qthloc42.zip/DESCRIPT.TXT

Text File | 1991-03-23 | 16KB | 391 lines

                   Stockholm              date   1991-02-27         page   1(8)
                   QTHLOC v 4.2 description      Copyright 1991
                   Curt Lundstedt, SM0GCW




       QTH - Locator and contest program
       =================================




          TABLE OF CONTENTS

  1    Common ......................................................   2

  1.1  Program copy and distribution conditions ....................   2
  1.2  A worldwide QTH-locator system designed for HAM-radio. ......   2
  1.3  Files QTHLOC produce or use .................................   3

  2    Useful features .............................................   3

  2.1  Determination of QTH-locator ................................   3
  2.2  Convert QTH-locator to longitude and latitude ...............   4
  2.3  Calculate direction and distance from QTH-locator ...........   4
  2.4  Calculate direction and distance from longitude and latitude    4

  3    Contest-log making ..........................................   5

  3.1  Common ......................................................   5
  3.2  HF VHF UHF SHF - contest ....................................   5
  3.3  "Free format" - contest .....................................   6
  3.4  Define new command rule .....................................   6
  3.5  Personal setup data .........................................   7
  3.6  Printer function ............................................   7
  3.7  Packet radio conversion function ............................   8

                    Stockholm              date   1991-02-27            page   2
                    QTHLOC v 4.2 description      Copyright 1991
                    Curt Lundstedt, SM0GCW



    1  Common

       This program will help you with the boring job to make contest-log.
       It will also help you to calculate distance and direction between
       to QTH:s. You can give input as QTH-locator or as longitude and
       latitude. The Program convert longitude and latitude to QTH-locator
       and the reverse is of course possible.
       This program is possible to run in both English (default) and
       Swedish language.


    1.1 Program copy and distribution conditions

       This program may be copied and distributed under this conditions:

       A. No fee is charged for its distribution.
       B. It must be distributed without modification.
       C. It may not be distributed by commercial firms without permission.

       If you find this program of use, a contribution of $10 ( or 50 Swedish
       kronor) will be helpful to make new and better versions of this program
       and new programs.

               Author  : Curt Lundstedt, SM0GCW
               address : Orvar Odds vag 10
                         S-112 54 STOCKHOLM
                                  SWEDEN
       If you write to me and want to have answer. You must send an envelope
       with your name and address + postage.
       You can also write to me on packet mailbox SM0GCW@SM0ETV
       or SM0GCW@SM5BKI.


    1.2 A worldwide QTH-locator system designed for HAM-radio.

       The earth's surface is divided into 18*18=324 "FIELDS", 20 degrees
       longitude and 10 degrees latitude. Each field is divided into 10*10=
       100 "SQUARES", 2 degrees longitude and 1 degrees latitude. Finally
       each square is divided into 24*24=576 "SUBSQUARES", 5 minutes
       longitude 2.5 minutes latitude.

       The fields are given by 2 letters AA - RR. The squares by 2 digits
       00 - 99. The subsquares by 2 letters AA - XX. The first character
       gives the longitude and the second character gives the latitude
       on each level. A complete locator are 6 character long.

       Example  59 degrees North, 18 degrees East, give locator JO99AA

        Reference literature:
                              The Radio Amateur's World Atlas  by SM5AGM
                              SSA, Ostmaksgatan 43  S-123 42 FARSTA SWEDEN



                    Stockholm              date   1991-02-27            page   3
                    QTHLOC v 4.2 description      Copyright 1991
                    Curt Lundstedt, SM0GCW



    1.3 Files QTHLOC produce or use

       QTHLOC.EXE     The QTHLOC program started under MS-dos

       QTHLOC.CNF     Contain your personal data. Station, antenna ...
       QTHLOC.DCL     Define commands for your favorite contest. This file
                      must be edit by your self.

       QTHLOCEN.HLP   Contain help text, and message. Written in English.
       QTHLOCSW.HLP   Contain help text, and message. Written in Swedish.

       QTHREC.REC     Records of QSO data.
       QTHREC.BAK     Backup of latest deleted QSO data, you can rename the
                      file and use it again if you need. Try to use this
                      file if you have deleted QTHREC.REC by mistake.

       xdate.PRI      Contest-log ready to print on your line-printer
       xdate.BAK      Backup of contest-log
                      ( x = type of test, H HF, V VHF, U UHF, S SHF
                        date = contest date )

       xdate.PAC      7 bit ASCII converted file for Packet radio

       DESCRIPT.TXT   This file.
       BESKRIVN.TXT   Swidish description.


    2  Useful features



    2.1 Determination of QTH-locator

       Look in a good map for your exact possition.
       You enter your longitude and latitude. Western longitude and
       southern latitude should be entered as negative values.

        Example 1
            18 degrees 2 minutes East longitude and 59 degrees 18
            minutes 40 seconds North latitude should be entered as
            18 2 0 and 59 18 40. The result will be  JO99AH

        Example 2
            117 degrees 5 minutes West and 34 degrees 25 minutes North
            should be entered as -117 -5 0 and 34 25 0.
            The result will be DM14KK



                    Stockholm              date   1991-02-27            page   4
                    QTHLOC v 4.2 description      Copyright 1991
                    Curt Lundstedt, SM0GCW



    2.2 Convert QTH-locator to longitude and latitude

       You enter the QTH-locator. The program will calculate and
       give you longitude and latitude. Western longitude and
       southern latitude is given as negative values.

        Example
            DM14LK  The result will be -117,-5 degrees longitude and
            34,25 degrees latitude. (117 degrees 5 minutes West and
            34 degrees 25 minutes North)


    2.3 Calculate direction and distance from QTH-locator

       Give the QTH-locator of the starting point and the point you
       will calculate. The program calculate and give you answer.

       Example 1
           JO99AH to KO03DX give 608 km and 166 degrees.

       Example 2
           DM14LK to GG66MA give 9834 km and 121 degrees.


    2.4 Calculate direction and distance from longitude and latitude

       Give your longitude and latitude of the starting point and
       the point will calculate. The program calculate and give you
       answer.
       Western longitude and southern latitude should be entered as
       negative values.

        Example 1
            18 degrees East, 59 degrees 18 minutes North to
            20 degrees 15 minutes East, 53 degrees 58 minutes North
            give 607.7 km and 166 degrees

        Example 2
            117 degrees 5 minutes Vest, 34 degrees 25 minutes North
            47 degrees vest, 24 degrees South
            ( you write  -117 -5 0 , 34 25 0  and  -47 0 0 , -24 0 0 )
            give 9836.9 km and 121 degrees

                    Stockholm              date   1991-02-27            page   5
                    QTHLOC v 4.2 description      Copyright 1991
                    Curt Lundstedt, SM0GCW



    3  Contest-log making



    3.1 Common

       Before you start enter the QSO-data for the contest, the
       configuration data must bee entered. This data is only
       entered the first time when you use this program or when
       your equipment is changed.

       You have 5 different commands to use when you calculate
       your contest-log. In the "free-format" command can you
       order very different types of score calculation. The
       other 4 commands is predefined for your favorite contests.
       Read more about how to do predefined command in 'define new
       command rule'.
       When you have made your choice, the QSO-entering can be
       started.

       You simply answer the questions. If you make anything wrong,
       use the up-, down-arrow or the rubout or insert command. With
       the arrow-keys you also can step to next QSO before or after.

       When you have entered all QSO press Esc or ctrl-c to continue
       to next step. If you have a file of QSO already stored on disk
       the program ask if you want to delete it. Don't be afraid, if
       you say Y the program store the old QSO-data under the name
       QTHREC.BAK (backup).


    3.2 HF VHF UHF SHF - contest

       You have four definable command for contest-log making. Default
       for this commands ( without QTHLOC.DCL file) is "Swedish rules
       for månadstest". You can easy define the rule for your favorite
       contest, see 'Define new command rule'.

       First, you enter your QSO-data. You simply answer the questions.
       If you make anything wrong, use the up-, down-arrow or the
       rubout or insert command. With the arrow-keys you also can step
       to next QSO before or after.
       When you have entered all QSO press Esc or ctrl-c to continue
       to next step. If you have a file of QSO already stored on disk
       the program ask if you want to delete it. Don't be afraid, if
       you say Y the program store the old QSO-data under the name
       QTHREC.BAK (backup).
       After that, you give the name of the contest and date for the
       contest.
       When all data is entered the program produce the contest-log.

                    Stockholm              date   1991-02-27            page   6
                    QTHLOC v 4.2 description      Copyright 1991
                    Curt Lundstedt, SM0GCW



    3.3 "Free format" - contest

       With this command it is possible to "program" your own
       contest-rules.
       Answer the questions on screen. Then press enter, escape or
       ctrl-c.

       The first question ask for one or more letter, A-I.

       A  one point per Km distance.
       B  one point per Km distance ( if > 2000 km = 2000 points ).
       C  one point per 10 Km distance.
       D  multiply factor * point per square.
       E  multiply factor * point per Call-prefix ( two first characters ).
       F  add factor * point per square to the total sum.
       G  add factor * point per Call-prefix to the total sum.
       H  multiply with every 100 MHz ( 144 give 1 point, 432 give 4 ...)
       I  multiply with every GHz ( 2304 give 2 point, 10368 give 10 ...)

       In some combinations you can add an bonus factor. At last you
       enter name of the contest and type of test.

       Example 1  C
           Give you one point per 10 km distance ( km is rounded
           up to next km )

       Example 2  F
           Give you one point per worked square. You can also ad
           bonus points per square.

       Example 3  AE  factor 20
           Give you one point per km multiply with 20 points per
           Call-prefix.

       Example 4  AI
           Give you one point per km multiply with number of GHz,
           a QSO on 2304 GHz and 65 km give 2 * 65 = 130 points.


    3.4 Define new command rule

       How to make commands for your favorite contest.
       You make a file with your ordinary editor. The file must be named
       QTHLOC.DCL .
       The file shall contain 4 lines. Line 1 HF, line 2 VHF,
       line 3 UHF, line 4 SHF. Each line shall have one or more letter
       just like 'free-format' command. After the letter you can add a
       bonus factor.

       A  one point per Km distance.
       B  one point per Km distance ( if > 2000 km = 2000 points ).
       C  one point per 10 Km distance.
       D  multiply factor * point per square.
       E  multiply factor * point per Call-prefix ( two first characters ).

                    Stockholm              date   1991-02-27            page   7
                    QTHLOC v 4.2 description      Copyright 1991
                    Curt Lundstedt, SM0GCW



       F  add factor * point per square to the total sum.
       G  add factor * point per Call-prefix to the total sum.
       H  multiply with every 100 MHz ( 144 give 1 point, 432 give 4 ...)
       I  multiply with every GHz ( 2304 give 2 point, 10368 give 10 ...)

       Example:
       HF  one point per km multiplication with one point per call-pref.
       VHF one point per km and 400 points per square.
       UHF one point per km with limits.
       UHF one point per km mult. with number of GHz for each QSO

       File:
       AE
       AF 400
       B
       AI


    3.5 Personal setup data

       Enter data about yourself and your station.
       Enter also number of line on your line-printer ( paper length)
       and the color on screen.
       This data is stored on disk and you need only to work with it
       when something is changed.
       If you have problem with your screen or if you want to change
       color this color are valid:

       0 : Black, 1 : Blue, 2 : Green, 3 : Cyan, 4 : Red, 5 : Magnenta
       6 : Brown, 7 : Gray, 8 : Lightgray, 9 : LightBlue, 10 : LightGreen
       11 : Lightcyan, 12 : Lightred, 13 : Lightmagenta, 14 : Yellow,
       15 : White.

       If you have black and white screen try with color text = 15,
       color background = 0 and color field = 0.

       This program can also be changed to Swedish language in the setup
       screen. Default is English language.


    3.6 Printer function

       This function use normal LPT1 output. You can use a editor to
       change the log-file. If you have a unusual printer use your own
       print-program direct to xdate.PRI file !
       You can also send this file to your contest-manager via packet
       radio.
       The first letter in file name depend on type of test:
       V = VHF  U = UHF  S = SHF  H = HF

       The rest of the name is date for the test.

                    Stockholm              date   1991-02-27            page   8
                    QTHLOC v 4.2 description      Copyright 1991
                    Curt Lundstedt, SM0GCW



    3.7 Packet radio conversion function

       This function is useful in northern countries using special
       letter 'åäö ÅÄÖ ...'. This letter must be converted to 7
       bit ASCII before you can send it via packet radio.